fix(skills): remove phantom slash commands from hermes-agent SKILL.md by liuhao1024 · Pull Request #50608 · NousResearch/hermes-agent

liuhao1024 · 2026-06-22T04:33:07Z

What does this PR do?

Removes two phantom slash commands from the hermes-agent SKILL.md that don't exist in the command registry, preventing agents from suggesting non-existent commands to users.

Related Issue

Fixes #50605

Type of Change

🐛 Bug fix (non-breaking change that fixes an issue)

Changes Made

skills/autonomous-ai-agents/hermes-agent/SKILL.md: Remove /skill <name> line (no such command exists; only /skills is registered)
skills/autonomous-ai-agents/hermes-agent/SKILL.md: Fix /quit alias list — remove /q (it is an alias for /queue, not /quit)
skills/autonomous-ai-agents/hermes-agent/SKILL.md: Update troubleshooting section to reference hermes -s name instead of nonexistent /skill

How to Test

Open skills/autonomous-ai-agents/hermes-agent/SKILL.md
Verify /skill <name> no longer appears in the Tools & Skills section (line ~300)
Verify /quit (/exit) in the Exit section no longer includes /q
Verify the troubleshooting "Skills not showing" section references hermes -s name only
Cross-reference with hermes_cli/commands.py: confirm /queue has alias q (line 107) and /quit has alias exit only (line 238)

Checklist

Code

I've read the Contributing Guide
My commit messages follow Conventional Commits (fix(scope):, feat(scope):, etc.)
I searched for existing PRs to make sure this isn't a duplicate
My PR contains only changes related to this fix/feature (no unrelated commits)
I've run pytest tests/ -q and all tests pass
I've added tests for my changes (required for bug fixes, strongly encouraged for features)
I've tested on my platform: macOS

Documentation & Housekeeping

I've updated relevant documentation (README, docs/, docstrings) — or N/A
I've updated cli-config.yaml.example if I added/changed config keys — or N/A
I've updated CONTRIBUTING.md or AGENTS.md if I changed architecture or workflows — or N/A
I've considered cross-platform impact (Windows, macOS) per the compatibility guide — or N/A
I've updated tool descriptions/schemas if I changed tool behavior — or N/A

Code Intelligence

⚠️ GitNexus unavailable (stale index) — grep-based fallback used.

Checked: hermes_cli/commands.py lines 106-108 (/queue alias q), 237-238 (/quit alias exit)
Blast radius: LOW — docs-only change, no code or behavior modified
Related patterns: Command registry in hermes_cli/commands.py defines all valid slash commands

- Remove `/skill <name>` (does not exist in command registry; only `/skills` exists) - Fix `/quit` alias: remove `/q` (it is an alias for `/queue`, not `/quit`) - Update troubleshooting section to reference `hermes -s name` instead of nonexistent `/skill` Fixes NousResearch#50605

teknium1

Thanks for identifying a real registry/documentation mismatch. Current main confirms the core correction: q belongs to /queue (hermes_cli/commands.py:110-111), /quit has only exit (hermes_cli/commands.py:253-254), and there is no built-in singular skill command (hermes_cli/commands.py:177-181).

Problems

The patch updates only skills/autonomous-ai-agents/hermes-agent/SKILL.md. The published English bundled-skill page still contains all three stale references at website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent.md:307, :353, and :850.
The zh-Hans bundled-skill mirror has the same stale references at website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent.md:296, :342, and :752.

Suggested changes

Synchronize those English and zh-Hans bundled-skill pages with this correction.

Automated hermes-sweeper review.

teknium1 · 2026-07-14T23:39:40Z

@@ -343,7 +342,7 @@ The registry of record is `hermes_cli/commands.py` — every consumer



Please synchronize this correction, plus the removed /skill references, to the published English and zh-Hans bundled-skill pages. Both currently still advertise /skill and /quit (/exit, /q) (website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent.md:307, :353, :850; localized mirror :296, :342, :752).

@liuhao1024

…rences Audited every reference against ground truth (COMMAND_REGISTRY, argparse --help output, TOOLSETS dict, provider profiles, DEFAULT_CONFIG) and corrected drift the restructure had carried over verbatim: - slash-commands.md: rebuilt from the live registry. Removes the phantom /skill command (never existed — skills load via /skills, hermes -s, or a skill's own /<name> command) and the wrong /q alias on /quit (/q belongs to /queue) — both reported by @liuhao1024 in #50608 and @gauravsaxena1997 in #50613. Adds ~25 real commands that were missing (/learn, /memory, /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, …) with correct aliases and CLI/GW scoping. - cli-reference.md: verified flags (-z/--oneshot, --tui/--cli, --safe-mode), real subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/ auth/webhook/cron/skin/pets, added missing top-level commands (fallback, project, moa, logs, console, hooks, security, backup); condensed tables. - providers-and-models.md: rebuilt from the 36 shipped provider profiles with their actual env vars (was 21 rows, several stale); folds in the alias system and fallback-chain command. - configuration.md: toolset table matches TOOLSETS (adds coding, computer_use, video_gen, context_engine, project; drops nonexistent messaging/rl), config sections match DEFAULT_CONFIG, STT/TTS provider lists match the shipped set. - background-systems.md: curator verbs match the argparse surface. - troubleshooting/security-privacy/windows-quirks/contributor-guide: fixed dangling 'section above/below' references from the body split; moved the reset-permissions playbook to security-privacy.md (its routing home). Reported-by: liuhao1024 <sunsky.lau@gmail.com> Reported-by: gauravsaxena1997

@liuhao1024

…rences Audited every reference against ground truth (COMMAND_REGISTRY, argparse --help output, TOOLSETS dict, provider profiles, DEFAULT_CONFIG) and corrected drift the restructure had carried over verbatim: - slash-commands.md: rebuilt from the live registry. Removes the phantom /skill command (never existed — skills load via /skills, hermes -s, or a skill's own /<name> command) and the wrong /q alias on /quit (/q belongs to /queue) — both reported by @liuhao1024 in #50608 and @gauravsaxena1997 in #50613. Adds ~25 real commands that were missing (/learn, /memory, /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, …) with correct aliases and CLI/GW scoping. - cli-reference.md: verified flags (-z/--oneshot, --tui/--cli, --safe-mode), real subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/ auth/webhook/cron/skin/pets, added missing top-level commands (fallback, project, moa, logs, console, hooks, security, backup); condensed tables. - providers-and-models.md: rebuilt from the 36 shipped provider profiles with their actual env vars (was 21 rows, several stale); folds in the alias system and fallback-chain command. - configuration.md: toolset table matches TOOLSETS (adds coding, computer_use, video_gen, context_engine, project; drops nonexistent messaging/rl), config sections match DEFAULT_CONFIG, STT/TTS provider lists match the shipped set. - background-systems.md: curator verbs match the argparse surface. - troubleshooting/security-privacy/windows-quirks/contributor-guide: fixed dangling 'section above/below' references from the body split; moved the reset-permissions playbook to security-privacy.md (its routing home). Reported-by: liuhao1024 <sunsky.lau@gmail.com> Reported-by: gauravsaxena1997

@liuhao1024

…rences Audited every reference against ground truth (COMMAND_REGISTRY, argparse --help output, TOOLSETS dict, provider profiles, DEFAULT_CONFIG) and corrected drift the restructure had carried over verbatim: - slash-commands.md: rebuilt from the live registry. Removes the phantom /skill command (never existed — skills load via /skills, hermes -s, or a skill's own /<name> command) and the wrong /q alias on /quit (/q belongs to /queue) — both reported by @liuhao1024 in #50608 and @gauravsaxena1997 in #50613. Adds ~25 real commands that were missing (/learn, /memory, /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, …) with correct aliases and CLI/GW scoping. - cli-reference.md: verified flags (-z/--oneshot, --tui/--cli, --safe-mode), real subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/ auth/webhook/cron/skin/pets, added missing top-level commands (fallback, project, moa, logs, console, hooks, security, backup); condensed tables. - providers-and-models.md: rebuilt from the 36 shipped provider profiles with their actual env vars (was 21 rows, several stale); folds in the alias system and fallback-chain command. - configuration.md: toolset table matches TOOLSETS (adds coding, computer_use, video_gen, context_engine, project; drops nonexistent messaging/rl), config sections match DEFAULT_CONFIG, STT/TTS provider lists match the shipped set. - background-systems.md: curator verbs match the argparse surface. - troubleshooting/security-privacy/windows-quirks/contributor-guide: fixed dangling 'section above/below' references from the body split; moved the reset-permissions playbook to security-privacy.md (its routing home). Reported-by: liuhao1024 <sunsky.lau@gmail.com> Reported-by: gauravsaxena1997

teknium1 · 2026-07-24T04:17:43Z

Closing with credit — your fix landed via #70511 (merged as 46c7a40). You were the earliest to catch both errors (phantom /skill, wrong /q alias); the merge commit carries a Reported-by trailer for you and your contributor email mapping was added. The branch itself couldn't be merged directly because the skill was restructured into a hub (#70452) and the lines moved into references/slash-commands.md, which was rebuilt from the live registry. Thanks!

@liuhao1024

…rences Audited every reference against ground truth (COMMAND_REGISTRY, argparse --help output, TOOLSETS dict, provider profiles, DEFAULT_CONFIG) and corrected drift the restructure had carried over verbatim: - slash-commands.md: rebuilt from the live registry. Removes the phantom /skill command (never existed — skills load via /skills, hermes -s, or a skill's own /<name> command) and the wrong /q alias on /quit (/q belongs to /queue) — both reported by @liuhao1024 in NousResearch#50608 and @gauravsaxena1997 in NousResearch#50613. Adds ~25 real commands that were missing (/learn, /memory, /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, …) with correct aliases and CLI/GW scoping. - cli-reference.md: verified flags (-z/--oneshot, --tui/--cli, --safe-mode), real subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/ auth/webhook/cron/skin/pets, added missing top-level commands (fallback, project, moa, logs, console, hooks, security, backup); condensed tables. - providers-and-models.md: rebuilt from the 36 shipped provider profiles with their actual env vars (was 21 rows, several stale); folds in the alias system and fallback-chain command. - configuration.md: toolset table matches TOOLSETS (adds coding, computer_use, video_gen, context_engine, project; drops nonexistent messaging/rl), config sections match DEFAULT_CONFIG, STT/TTS provider lists match the shipped set. - background-systems.md: curator verbs match the argparse surface. - troubleshooting/security-privacy/windows-quirks/contributor-guide: fixed dangling 'section above/below' references from the body split; moved the reset-permissions playbook to security-privacy.md (its routing home). Reported-by: liuhao1024 <sunsky.lau@gmail.com> Reported-by: gauravsaxena1997

@liuhao1024

…rences Audited every reference against ground truth (COMMAND_REGISTRY, argparse --help output, TOOLSETS dict, provider profiles, DEFAULT_CONFIG) and corrected drift the restructure had carried over verbatim: - slash-commands.md: rebuilt from the live registry. Removes the phantom /skill command (never existed — skills load via /skills, hermes -s, or a skill's own /<name> command) and the wrong /q alias on /quit (/q belongs to /queue) — both reported by @liuhao1024 in NousResearch#50608 and @gauravsaxena1997 in NousResearch#50613. Adds ~25 real commands that were missing (/learn, /memory, /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, …) with correct aliases and CLI/GW scoping. - cli-reference.md: verified flags (-z/--oneshot, --tui/--cli, --safe-mode), real subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/ auth/webhook/cron/skin/pets, added missing top-level commands (fallback, project, moa, logs, console, hooks, security, backup); condensed tables. - providers-and-models.md: rebuilt from the 36 shipped provider profiles with their actual env vars (was 21 rows, several stale); folds in the alias system and fallback-chain command. - configuration.md: toolset table matches TOOLSETS (adds coding, computer_use, video_gen, context_engine, project; drops nonexistent messaging/rl), config sections match DEFAULT_CONFIG, STT/TTS provider lists match the shipped set. - background-systems.md: curator verbs match the argparse surface. - troubleshooting/security-privacy/windows-quirks/contributor-guide: fixed dangling 'section above/below' references from the body split; moved the reset-permissions playbook to security-privacy.md (its routing home). Reported-by: liuhao1024 <sunsky.lau@gmail.com> Reported-by: gauravsaxena1997

@liuhao1024

…rences Audited every reference against ground truth (COMMAND_REGISTRY, argparse --help output, TOOLSETS dict, provider profiles, DEFAULT_CONFIG) and corrected drift the restructure had carried over verbatim: - slash-commands.md: rebuilt from the live registry. Removes the phantom /skill command (never existed — skills load via /skills, hermes -s, or a skill's own /<name> command) and the wrong /q alias on /quit (/q belongs to /queue) — both reported by @liuhao1024 in NousResearch#50608 and @gauravsaxena1997 in NousResearch#50613. Adds ~25 real commands that were missing (/learn, /memory, /pet, /hatch, /bundles, /moa, /suggestions, /blueprint, /whoami, …) with correct aliases and CLI/GW scoping. - cli-reference.md: verified flags (-z/--oneshot, --tui/--cli, --safe-mode), real subcommand sets for config/setup/sessions/skills/gateway/mcp/profile/ auth/webhook/cron/skin/pets, added missing top-level commands (fallback, project, moa, logs, console, hooks, security, backup); condensed tables. - providers-and-models.md: rebuilt from the 36 shipped provider profiles with their actual env vars (was 21 rows, several stale); folds in the alias system and fallback-chain command. - configuration.md: toolset table matches TOOLSETS (adds coding, computer_use, video_gen, context_engine, project; drops nonexistent messaging/rl), config sections match DEFAULT_CONFIG, STT/TTS provider lists match the shipped set. - background-systems.md: curator verbs match the argparse surface. - troubleshooting/security-privacy/windows-quirks/contributor-guide: fixed dangling 'section above/below' references from the body split; moved the reset-permissions playbook to security-privacy.md (its routing home). Reported-by: liuhao1024 <sunsky.lau@gmail.com> Reported-by: gauravsaxena1997

alt-glitch added type/docs Documentation improvements tool/skills Skills system (list, view, manage) P3 Low — cosmetic, nice to have labels Jun 22, 2026

alt-glitch mentioned this pull request Jun 22, 2026

docs: fix hermes-agent skill slash command references #50613

Closed

kmnoh12 mentioned this pull request Jun 23, 2026

Bundled hermes-agent skill is too monolithic, costly to load, and forces users into update-drift tradeoffs #51387

Closed

This was referenced Jul 12, 2026

docs(cli): remove phantom slash commands #62933

Closed

fix(docs): remove phantom /skill and /q alias from hermes-agent SKILL.md #63451

Closed

teknium1 reviewed Jul 14, 2026

View reviewed changes

teknium1 added the sweeper:blast-contained Sweeper blast radius: contained — one narrow path / opt-in / few users label Jul 15, 2026

GottZ mentioned this pull request Jul 19, 2026

Docs: hermes-agent SKILL.md documents phantom slash commands (/skill, /q) #50605

Closed

teknium1 mentioned this pull request Jul 24, 2026

fix(skills): accuracy + concision pass over the hermes-agent hub references #70511

Merged

teknium1 closed this in #70511 Jul 24, 2026

Navigation Menu

Repository navigation

fix(skills): remove phantom slash commands from hermes-agent SKILL.md - #50608

fix(skills): remove phantom slash commands from hermes-agent SKILL.md#50608
liuhao1024 wants to merge 1 commit into
NousResearch:mainfrom
liuhao1024:liuhao/cron-bugfix-50605-skill-docs-phantom-commands

liuhao1024 commented Jun 22, 2026

Uh oh!

teknium1 left a comment

Uh oh!

teknium1 Jul 14, 2026

Uh oh!

teknium1 commented Jul 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -343,7 +342,7 @@ The registry of record is `hermes_cli/commands.py` — every consumer

Conversation

liuhao1024 commented Jun 22, 2026

What does this PR do?

Related Issue

Type of Change

Changes Made

How to Test

Checklist

Code

Documentation & Housekeeping

Code Intelligence

Uh oh!

teknium1 left a comment

Choose a reason for hiding this comment

Problems

Suggested changes

Uh oh!

teknium1 Jul 14, 2026

Choose a reason for hiding this comment

Uh oh!

teknium1 commented Jul 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants